feat(api): implement saved filters backend service and handlers

Add complete backend implementation for saved filters CRUD operations
with proper service layer architecture and RESTful API endpoints.

Service Layer (internal/services/filters.go):
- NewFiltersService() constructor following project patterns
- GetSavedFilters(): Retrieve all filters for user + resource type
- CreateSavedFilter(): Create filter with duplicate name validation
- UpdateSavedFilter(): Update filter with ownership verification
- DeleteSavedFilter(): Delete filter with user scoping

Business Logic:
- Filter name uniqueness enforced per user + resource type
- User ownership validation on all operations (JWT user_id)
- JSONB marshaling/unmarshaling for flexible filter storage
- Proper error wrapping with context messages

Handler Layer (internal/handlers/filters.go):
- NewFiltersHandler() constructor (receives db.Queries)
- GetSavedFilters: GET /api/saved-filters?resource_type=X
- CreateSavedFilter: POST /api/saved-filters
- UpdateSavedFilter: PUT /api/saved-filters/:id
- DeleteSavedFilter: DELETE /api/saved-filters/:id

Content Negotiation:
- Supports both JSON (API clients) and HTML (HTMX) responses
- wantsHTML() helper checks Accept header
- HX-Redirect header for HTMX form submissions
- Proper status codes (200, 201, 204, 400, 401, 404, 409)

Router Configuration:
- registerFiltersRoutes() function in internal/router/filters.go
- JWT middleware protection on all endpoints
- RESTful route structure: /api/saved-filters
- Registered in main router.go RegisterRoutes() function
- Added FiltersHandler to router.Config struct

Test Infrastructure:
- Added FiltersHandler to test server setup (test_helpers_test.go)
- FiltersHandler initialized in setupTestServer() function
- Router.Config includes FiltersHandler for integration tests

Code Quality:
- Follows PROJECT_GUIDELINES.md service layer patterns
- Uses database models (not custom domain models)
- JSONB returned as []byte (matches collections pattern)
- All errors wrapped with context using fmt.Errorf
- Handlers create services internally (not dependency injection)

Part of: Saved Filters Implementation (Phase 2: Backend)
Related: #saved-filters-feature

This commit is contained in:

john-okeefe

2026-03-21 00:16:10 -04:00

parent e17a96123f

commit ddfc832b68

5 changed files with 329 additions and 0 deletions

									
										internal/router/router.go
									
		+2
		
												View File
												
				@@ -52,6 +52,7 @@ type Config struct {

					QueueHandler          *handlers.QueueHandler

					CollectionHandler     *handlers.CollectionHandler

					Worker                *services.Worker

					FiltersHandler        *handlers.FiltersHandler

					DashboardHandler      *handlers.DashboardHandler

					DashboardService      *services.DashboardService

					OPDSHandler           *handlers.OPDSHandler

				@@ -215,6 +216,7 @@ func RegisterRoutes(cfg *Config) *handlers.Handler {

					registerAnalyticsRoutes(cfg)

					registerQueueRoutes(cfg)

					registerJobRoutes(cfg)

					registerFiltersRoutes(cfg)

					registerOPDSRoutes(cfg)

					registerWebSocketRoutes(cfg)

					registerFrontendRoutes(cfg)