feat: endpoint to serve readable content

docs/swagger/docs.go

@@ -159,6 +159,28 @@ const docTemplate = `{
                 }
             }
         },
+        "/api/v1/bookmarks/id/readable": {
+            "get": {
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Auth"
+                ],
+                "summary": "Get readable version of bookmark.",
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/api_v1.contentResponseMessage"
+                        }
+                    },
+                    "401": {
+                        "description": "Token not provided/invalid"
+                    }
+                }
+            }
+        },
         "/api/v1/tags": {
             "get": {
                 "produces": [
@@ -206,6 +228,17 @@ const docTemplate = `{
         }
     },
     "definitions": {
+        "api_v1.contentResponseMessage": {
+            "type": "object",
+            "properties": {
+                "content": {
+                    "type": "string"
+                },
+                "html": {
+                    "type": "string"
+                }
+            }
+        },
         "api_v1.loginRequestPayload": {
             "type": "object",
             "required": [

docs/swagger/swagger.json

@@ -148,6 +148,28 @@
                 }
             }
         },
+        "/api/v1/bookmarks/id/readable": {
+            "get": {
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Auth"
+                ],
+                "summary": "Get readable version of bookmark.",
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/api_v1.contentResponseMessage"
+                        }
+                    },
+                    "401": {
+                        "description": "Token not provided/invalid"
+                    }
+                }
+            }
+        },
         "/api/v1/tags": {
             "get": {
                 "produces": [
@@ -195,6 +217,17 @@
         }
     },
     "definitions": {
+        "api_v1.contentResponseMessage": {
+            "type": "object",
+            "properties": {
+                "content": {
+                    "type": "string"
+                },
+                "html": {
+                    "type": "string"
+                }
+            }
+        },
         "api_v1.loginRequestPayload": {
             "type": "object",
             "required": [

docs/swagger/swagger.yaml

@@ -1,4 +1,11 @@
 definitions:
+  api_v1.contentResponseMessage:
+    properties:
+      content:
+        type: string
+      html:
+        type: string
+    type: object
   api_v1.loginRequestPayload:
     properties:
       password:
@@ -218,6 +225,20 @@ paths:
       summary: Update Cache and Ebook on server.
       tags:
       - Auth
+  /api/v1/bookmarks/id/readable:
+    get:
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/api_v1.contentResponseMessage'
+        "401":
+          description: Token not provided/invalid
+      summary: Get readable version of bookmark.
+      tags:
+      - Auth
   /api/v1/tags:
     get:
       produces:

internal/http/routes/api/v1/bookmarks.go

@@ -27,6 +27,7 @@
 func (r *BookmarksAPIRoutes) Setup(g *gin.RouterGroup) model.Routes {
 	g.Use(middleware.AuthenticationRequired())
 	g.PUT("/cache", r.updateCache)
+	g.GET("/:id/readable", r.bookmarkReadable)
 	return r
 }
 
@@ -57,6 +58,63 @@
 	return nil
 }
 
+type contentResponseMessage struct {
+	Content string `json:"content"`
+	Html    string `json:"html"`
+}
+
+func (r *BookmarksAPIRoutes) getBookmark(c *context.Context) (*model.BookmarkDTO, error) {
+	bookmarkIDParam, present := c.Params.Get("id")
+	if !present {
+		response.SendError(c.Context, http.StatusBadRequest, "Invalid bookmark ID")
+		return nil, model.ErrBookmarkInvalidID
+	}
+
+	bookmarkID, err := strconv.Atoi(bookmarkIDParam)
+	if err != nil {
+		r.logger.WithError(err).Error("error parsing bookmark ID parameter")
+		response.SendInternalServerError(c.Context)
+		return nil, err
+	}
+
+	if bookmarkID == 0 {
+		response.SendError(c.Context, http.StatusNotFound, nil)
+		return nil, model.ErrBookmarkNotFound
+	}
+
+	bookmark, err := r.deps.Domains.Bookmarks.GetBookmark(c.Context, model.DBID(bookmarkID))
+	if err != nil {
+		response.SendError(c.Context, http.StatusNotFound, nil)
+		return nil, model.ErrBookmarkNotFound
+	}
+
+	return bookmark, nil
+}
+
+// Bookmark Readable godoc
+//
+//	@Summary					Get readable version of bookmark.
+//	@Tags						Auth
+//	@securityDefinitions.apikey	ApiKeyAuth
+//	@Produce					json
+//	@Success					200	{object}    contentResponseMessage
+//	@Failure					401	{object}	nil	"Token not provided/invalid"
+//	@Router						/api/v1/bookmarks/id/readable [get]
+func (r *BookmarksAPIRoutes) bookmarkReadable(c *gin.Context) {
+	ctx := context.NewContextFromGin(c)
+
+	bookmark, err := r.getBookmark(ctx)
+	if err != nil {
+		return
+	}
+	responseMessage := contentResponseMessage{
+		Content: bookmark.Content,
+		Html:    bookmark.HTML,
+	}
+
+	response.Send(c, 200, responseMessage)
+}
+
 // updateCache godoc
 //
 //	@Summary					Update Cache and Ebook on server.