[api/3rdparty] move /devices group to distinct controller

Author: capcom6

Diff for: api/requests.http

@@ -45,7 +45,7 @@ GET {{baseUrl}}/api/3rdparty/v1/message/2dcIAhcLg81cez7GE_Pdp HTTP/1.1
 Authorization: Basic {{credentials}}
 
 ###
-GET {{baseUrl}}/api/3rdparty/v1/device HTTP/1.1
+GET {{baseUrl}}/api/3rdparty/v1/devices HTTP/1.1
 Authorization: Basic {{credentials}}
 
 ###

Diff for: internal/sms-gateway/handlers/3rdparty.go

@@ -6,13 +6,13 @@ import (
 
 	"github.com/android-sms-gateway/client-go/smsgateway"
 	"github.com/capcom6/sms-gateway/internal/sms-gateway/handlers/base"
+	devicesCtrl "github.com/capcom6/sms-gateway/internal/sms-gateway/handlers/devices"
 	"github.com/capcom6/sms-gateway/internal/sms-gateway/handlers/webhooks"
 	"github.com/capcom6/sms-gateway/internal/sms-gateway/models"
 	"github.com/capcom6/sms-gateway/internal/sms-gateway/modules/auth"
 	"github.com/capcom6/sms-gateway/internal/sms-gateway/modules/devices"
 	"github.com/capcom6/sms-gateway/internal/sms-gateway/modules/messages"
 	"github.com/capcom6/sms-gateway/internal/sms-gateway/repositories"
-	"github.com/capcom6/sms-gateway/pkg/types"
 	"github.com/go-playground/validator/v10"
 	"github.com/gofiber/fiber/v2"
 	"github.com/gofiber/fiber/v2/middleware/basicauth"
@@ -29,6 +29,7 @@ type ThirdPartyHandlerParams struct {
 
 	HealthHandler   *healthHandler
 	WebhooksHandler *webhooks.ThirdPartyController
+	DevicesHandler  *devicesCtrl.ThirdPartyController
 
 	AuthSvc     *auth.Service
 	MessagesSvc *messages.Service
@@ -43,46 +44,13 @@ type thirdPartyHandler struct {
 
 	healthHandler   *healthHandler
 	webhooksHandler *webhooks.ThirdPartyController
+	devicesHandler  *devicesCtrl.ThirdPartyController
 
 	authSvc     *auth.Service
 	messagesSvc *messages.Service
 	devicesSvc  *devices.Service
 }
 
-//	@Summary		List devices
-//	@Description	Returns list of registered devices
-//	@Security		ApiAuth
-//	@Tags			User
-//	@Produce		json
-//	@Success		200	{object}	[]smsgateway.Device			"Device list"
-//	@Failure		400	{object}	smsgateway.ErrorResponse	"Invalid request"
-//	@Failure		401	{object}	smsgateway.ErrorResponse	"Unauthorized"
-//	@Failure		500	{object}	smsgateway.ErrorResponse	"Internal server error"
-//	@Router			/3rdparty/v1/device [get]
-//
-// List devices
-func (h *thirdPartyHandler) getDevice(user models.User, c *fiber.Ctx) error {
-	devices, err := h.devicesSvc.Select(devices.WithUserID(user.ID))
-	if err != nil {
-		return fmt.Errorf("can't select devices: %w", err)
-	}
-
-	response := make([]smsgateway.Device, 0, len(devices))
-
-	for _, device := range devices {
-		response = append(response, smsgateway.Device{
-			ID:        device.ID,
-			Name:      types.OrDefault[string](device.Name, ""),
-			CreatedAt: device.CreatedAt,
-			UpdatedAt: device.UpdatedAt,
-			DeletedAt: device.DeletedAt,
-			LastSeen:  device.LastSeen,
-		})
-	}
-
-	return c.JSON(response)
-}
-
 //	@Summary		Enqueue message
 //	@Description	Enqueues message for sending. If ID is not specified, it will be generated
 //	@Security		ApiAuth
@@ -196,11 +164,11 @@ func (h *thirdPartyHandler) Register(router fiber.Router) {
 		return c.Next()
 	})
 
-	router.Get("/device", auth.WithUser(h.getDevice))
-
 	router.Post("/message", auth.WithUser(h.postMessage))
 	router.Get("/message/:id", auth.WithUser(h.getMessage)).Name(route3rdPartyGetMessage)
 
+	h.devicesHandler.Register(router.Group("/device")) // TODO: remove after 2025-07-11
+	h.devicesHandler.Register(router.Group("/devices"))
 	h.webhooksHandler.Register(router.Group("/webhooks"))
 }
 
@@ -209,6 +177,7 @@ func newThirdPartyHandler(params ThirdPartyHandlerParams) *thirdPartyHandler {
 		Handler:         base.Handler{Logger: params.Logger.Named("ThirdPartyHandler"), Validator: params.Validator},
 		healthHandler:   params.HealthHandler,
 		webhooksHandler: params.WebhooksHandler,
+		devicesHandler:  params.DevicesHandler,
 		authSvc:         params.AuthSvc,
 		messagesSvc:     params.MessagesSvc,
 		devicesSvc:      params.DevicesSvc,

Diff for: internal/sms-gateway/handlers/devices/3rdparty.go

@@ -0,0 +1,75 @@
+package devices
+
+import (
+	"fmt"
+
+	"github.com/android-sms-gateway/client-go/smsgateway"
+	"github.com/capcom6/go-helpers/slices"
+	"github.com/capcom6/sms-gateway/internal/sms-gateway/handlers/base"
+	"github.com/capcom6/sms-gateway/internal/sms-gateway/models"
+	"github.com/capcom6/sms-gateway/internal/sms-gateway/modules/auth"
+	"github.com/capcom6/sms-gateway/internal/sms-gateway/modules/devices"
+	"github.com/capcom6/sms-gateway/pkg/types"
+	"github.com/gofiber/fiber/v2"
+	"go.uber.org/fx"
+	"go.uber.org/zap"
+)
+
+type thirdPartyControllerParams struct {
+	fx.In
+
+	DevicesSvc *devices.Service
+
+	Logger *zap.Logger
+}
+
+type ThirdPartyController struct {
+	base.Handler
+
+	devicesSvc *devices.Service
+}
+
+//	@Summary		List devices
+//	@Description	Returns list of registered devices
+//	@Security		ApiAuth
+//	@Tags			User
+//	@Produce		json
+//	@Success		200	{object}	[]smsgateway.Device			"Device list"
+//	@Failure		400	{object}	smsgateway.ErrorResponse	"Invalid request"
+//	@Failure		401	{object}	smsgateway.ErrorResponse	"Unauthorized"
+//	@Failure		500	{object}	smsgateway.ErrorResponse	"Internal server error"
+//	@Router			/3rdparty/v1/devices [get]
+//
+// List devices
+func (h *ThirdPartyController) getDevices(user models.User, c *fiber.Ctx) error {
+	devices, err := h.devicesSvc.Select(devices.WithUserID(user.ID))
+	if err != nil {
+		return fmt.Errorf("can't select devices: %w", err)
+	}
+
+	response := slices.Map(devices, func(device models.Device) smsgateway.Device {
+		return smsgateway.Device{
+			ID:        device.ID,
+			Name:      types.OrDefault(device.Name, ""),
+			CreatedAt: device.CreatedAt,
+			UpdatedAt: device.UpdatedAt,
+			DeletedAt: device.DeletedAt,
+			LastSeen:  device.LastSeen,
+		}
+	})
+
+	return c.JSON(response)
+}
+
+func (h *ThirdPartyController) Register(router fiber.Router) {
+	router.Get("", auth.WithUser(h.getDevices))
+}
+
+func NewThirdPartyController(params thirdPartyControllerParams) *ThirdPartyController {
+	return &ThirdPartyController{
+		Handler: base.Handler{
+			Logger: params.Logger.Named("devices"),
+		},
+		devicesSvc: params.DevicesSvc,
+	}
+}

Diff for: internal/sms-gateway/handlers/module.go

@@ -2,6 +2,7 @@ package handlers
 
 import (
 	"github.com/capcom6/go-infra-fx/http"
+	"github.com/capcom6/sms-gateway/internal/sms-gateway/handlers/devices"
 	"github.com/capcom6/sms-gateway/internal/sms-gateway/handlers/webhooks"
 	"go.uber.org/fx"
 	"go.uber.org/zap"
@@ -22,6 +23,7 @@ var Module = fx.Module(
 		newHealthHandler,
 		webhooks.NewThirdPartyController,
 		webhooks.NewMobileController,
+		devices.NewThirdPartyController,
 		fx.Private,
 	),
 )

Diff for: internal/sms-gateway/handlers/webhooks/3rdparty.go

@@ -108,7 +108,7 @@ func (h *ThirdPartyController) Register(router fiber.Router) {
 func NewThirdPartyController(params thirdPartyControllerParams) *ThirdPartyController {
 	return &ThirdPartyController{
 		Handler: base.Handler{
-			Logger:    params.Logger.Named("controller"),
+			Logger:    params.Logger.Named("webhooks"),
 			Validator: params.Validator,
 		},
 		webhooksSvc: params.WebhooksSvc,

Diff for: internal/sms-gateway/handlers/webhooks/mobile.go

@@ -53,7 +53,7 @@ func (h *MobileController) Register(router fiber.Router) {
 func NewMobileController(params mobileControllerParams) *MobileController {
 	return &MobileController{
 		Handler: base.Handler{
-			Logger: params.Logger.Named("mobile"),
+			Logger: params.Logger.Named("webhooks"),
 		},
 		webhooksSvc: params.WebhooksServices,
 	}