π 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"
"strconv"
"github.com/gin-gonic/gin"
)
type NodeController interface {
GetPublicNode(c *gin.Context) (int, any)
GetSharedNodes(c *gin.Context) (int, any)
GetNodes(c *gin.Context) (int, any)
GetNode(c *gin.Context) (int, any)
SearchNodes(c *gin.Context) (int, any)
CreateNode(c *gin.Context) (int, any)
UpdateNode(c *gin.Context) (int, any)
DeleteNode(c *gin.Context) (int, any)
}
func NewNodeController(app *app.App) NodeController {
utils.InitBluemonday()
return &Controller{
app: app,
}
}
// GetPublicNode
// @Method GET
// @Description Retrieve a public node by its ID.
// @Param id path string true "Node ID"
// @Router /nodes/public/{id} [get]
func (ctr *Controller) GetPublicNode(c *gin.Context) (int, any) {
nodeId, err := utils.GetTargetId(c, c.Param("nodeId"))
if err != nil {
return http.StatusBadRequest, err
}
node, err := ctr.app.Services.Node.GetPublicNode(nodeId)
if err != nil {
return http.StatusInternalServerError, err
}
return http.StatusOK, node
}
// GetSharedNodes retrieves nodes shared with the connected user
// @Method GET
// @Description Retrieve nodes shared with the connected user.
// @Param userId path string true "Target User ID"
// @Router /nodes/shared/{userId} [get]
func (ctr *Controller) GetSharedNodes(c *gin.Context) (int, any) {
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
targetUserId, err := utils.GetTargetId(c, c.Param("userId"))
if err != nil {
return http.StatusBadRequest, err
}
nodes, err := ctr.app.Services.Node.GetSharedNodes(c.Request.Context(), targetUserId)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, nodes
}
// GetNodes retrieves all nodes for a target user
// @Method GET
// @Description Retrieve all nodes for a target user.
// @Param userId path string true "Target User ID"
// @Router /nodes/{userId} [get]
func (ctr *Controller) GetNodes(c *gin.Context) (int, any) {
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
targetUserId, err := utils.GetTargetId(c, c.Param("userId"))
if err != nil {
return http.StatusBadRequest, err
}
nodes, err := ctr.app.Services.Node.GetAllNodes(c.Request.Context(), targetUserId)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, nodes
}
// GetNode retrieves a specific node by its ID
// @Method GET
// @Description Retrieve a specific node by its ID.
// @Param id path string true "Node ID"
// @Router /nodes/{userId}/{id} [get]
func (ctr *Controller) GetNode(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
}
result, err := ctr.app.Services.Node.GetNode(c.Request.Context(), nodeId)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, result
}
// SearchNodes searches for nodes based on a query
// @Method GET
// @Description Search for nodes based on a query.
// @Router /nodes/search [get]
// @Query params:
// - q: search query (required, min 2 chars)
// - content: include content body in search (optional, default false)
// - limit: max results (optional, default 20, max 100)
func (ctr *Controller) SearchNodes(c *gin.Context) (int, any) {
query := c.Query("q")
if len(query) < 2 {
return http.StatusBadRequest, "Search query must be at least 2 characters"
}
includeContent := c.Query("content") == "true"
limit := 20
if limitStr := c.Query("limit"); limitStr != "" {
if parsedLimit, err := strconv.Atoi(limitStr); err == nil && parsedLimit > 0 {
limit = parsedLimit
}
}
results, err := ctr.app.Services.Node.SearchNodes(c.Request.Context(), query, includeContent, limit)
if err != nil {
return http.StatusInternalServerError, err
}
return http.StatusOK, results
}
// CreateNode creates a new node
// @Method POST
// @Description Create a new node.
// @Router /nodes [post]
func (ctr *Controller) CreateNode(c *gin.Context) (int, any) {
var node models.Node
if err := c.ShouldBind(&node); err != nil {
return http.StatusBadRequest, err
}
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
createdNode, err := ctr.app.Services.Node.CreateNode(c.Request.Context(), &node)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, createdNode
}
// UpdateNode updates an existing node
// @Method PUT
// @Description Update an existing node.
// @Param id path string true "Node ID"
// @Router /nodes/{id} [put]
func (ctr *Controller) UpdateNode(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
}
var node models.Node
if err := c.ShouldBind(&node); err != nil {
return http.StatusBadRequest, err
}
updatedNode, err := ctr.app.Services.Node.UpdateNode(c.Request.Context(), nodeId, &node)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, updatedNode
}
// DeleteNode deletes a node by its ID
// @Method DELETE
// @Description Delete a node by its ID.
// @Param id path string true "Node ID"
// @Router /nodes/{id} [delete]
func (ctr *Controller) DeleteNode(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
}
err = ctr.app.Services.Node.DeleteNode(c.Request.Context(), nodeId)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, "OK"
}