History_Api/internal/controllers/wikiController.go

package controllers

import (
	"context"
	"history-api/internal/dtos/request"
	"history-api/internal/dtos/response"
	"history-api/internal/services"
	"history-api/pkg/validator"
	"time"

	"github.com/gofiber/fiber/v3"
)

type WikiController struct {
	service services.WikiService
}

func NewWikiController(svc services.WikiService) *WikiController {
	return &WikiController{service: svc}
}

// GetWikiById handles fetching a single wiki by ID.
// @Summary      Get wiki by ID
// @Description  Get detailed information about a specific wiki
// @Tags         Wikis
// @Accept       json
// @Produce      json
// @Param        id   path      string  true  "Wiki ID"
// @Success      200  {object}  response.CommonResponse
// @Failure      500  {object}  response.CommonResponse
// @Router       /wikis/{id} [get]
func (h *WikiController) GetWikiById(c fiber.Ctx) error {
	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
	defer cancel()
	id := c.Params("id")
	res, err := h.service.GetWikiByID(ctx, id)
	if err != nil {
		return c.Status(err.Code).JSON(response.CommonResponse{
			Status:  false,
			Message: err.Message,
		})
	}
	return c.Status(fiber.StatusOK).JSON(response.CommonResponse{
		Status: true,
		Data:   res,
	})
}

// GetWikiBySlug handles fetching a single wiki by slug.
// @Summary      Get wiki by slug
// @Description  Get detailed information about a specific wiki by its unique slug
// @Tags         Wikis
// @Accept       json
// @Produce      json
// @Param        slug   path      string  true  "Wiki Slug"
// @Success      200  {object}  response.CommonResponse
// @Failure      404  {object}  response.CommonResponse
// @Router       /wikis/slug/{slug} [get]
func (h *WikiController) GetWikiBySlug(c fiber.Ctx) error {
	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
	defer cancel()
	slug := c.Params("slug")
	res, err := h.service.GetWikiBySlug(ctx, slug)
	if err != nil {
		return c.Status(err.Code).JSON(response.CommonResponse{
			Status:  false,
			Message: err.Message,
		})
	}
	return c.Status(fiber.StatusOK).JSON(response.CommonResponse{
		Status: true,
		Data:   res,
	})
}

// IsExistWikiSlug checks if a wiki slug already exists.
// @Summary      Check wiki slug existence
// @Description  Check if a given slug already exists for wikis
// @Tags         Wikis
// @Accept       json
// @Produce      json
// @Param        slug       query     string  true   "Slug to check"
// @Success      200  {object}  response.CommonResponse
// @Failure      400  {object}  response.CommonResponse
// @Router       /wikis/slug/exists [get]
func (h *WikiController) IsExistWikiSlug(c fiber.Ctx) error {
	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
	defer cancel()
	slug := c.Query("slug")
	exists, err := h.service.IsExistWikiSlug(ctx, slug)
	if err != nil {
		return c.Status(err.Code).JSON(response.CommonResponse{
			Status:  false,
			Message: err.Message,
		})
	}
	return c.Status(fiber.StatusOK).JSON(response.CommonResponse{
		Status: true,
		Data:   map[string]bool{"exists": exists},
	})
}

// SearchWikis handles searching for wikis.
// @Summary      Search wikis
// @Description  Search wikis with cursor pagination
// @Tags         Wikis
// @Accept       json
// @Produce      json
// @Param query query request.SearchWikiDto false "Search Query"
// @Success      200  {object}  response.CommonResponse
// @Failure      500  {object}  response.CommonResponse
// @Router       /wikis [get]
func (h *WikiController) SearchWikis(c fiber.Ctx) error {
	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
	defer cancel()

	dto := &request.SearchWikiDto{}
	if err := validator.ValidateQueryDto(c, dto); err != nil {
		return c.Status(fiber.StatusBadRequest).JSON(response.CommonResponse{
			Status: false,
			Errors: err,
		})
	}

	res, err := h.service.SearchWikis(ctx, dto)
	if err != nil {
		return c.Status(err.Code).JSON(response.CommonResponse{
			Status:  false,
			Message: err.Message,
		})
	}

	return c.Status(fiber.StatusOK).JSON(response.CommonResponse{
		Status: true,
		Data:   res,
	})
}