Remove the deprecated routes for PDF icons/thumbnails (#4358)

This route has been removed and added back several times as it was still
used by some webapps. Let's try again.

Author: shepilov

docs/files.md

@@ -1069,18 +1069,6 @@ parameter in the query-string (1 is the first page).
 GET /files/download?Path=/Documents/hello.txt&Dl=1 HTTP/1.1
 ```
 
-### GET /files/:file-id/icon/:secret
-
-Get an image that shows the first page of a PDF in a small resolution (96x96).
-
-**Note:** this route is deprecated, you should use thumbnails instead.
-
-### GET /files/:file-id/preview/:secret
-
-Get an image that shows the first page of a PDF (at most 1080x1920).
-
-**Note:** this route is deprecated, you should use thumbnails instead.
-
 ### GET /files/:file-id/thumbnails/:secret/:format
 
 Get a thumbnail of a file (for an image & pdf only). `:format` can be `tiny` (96x96)

docs/important-changes.md

@@ -4,6 +4,12 @@
 
 This section will list important changes to the stack or its usage, and migration procedures if any is needed.
 
+## April 2024: Routes for PDF
+
+The deprecated routes for getting the icon or preview of a PDF file has been removed.
+
+You should use the thumbnails instead.
+
 ## December 2023: Iterations for PBKDF2 increased
 
 We have increased the number of PBKDF2 iterations for new users to 650_000, and removed the exception for Edge as it now supports PBKDF2 via the subtle crypto API.

model/vfs/pdf.go

@@ -39,8 +39,6 @@ type LinksList struct {
 	Small  string `json:"small,omitempty"`
 	Medium string `json:"medium,omitempty"`
 	Large  string `json:"large,omitempty"`
-	// Preview for PDF
-	Preview string `json:"preview,omitempty"`
 }
 
 // Relationship is a resource linkage, as described in JSON-API

pkg/jsonapi/data.go

@@ -1055,56 +1055,6 @@ func HeadDirOrFile(c echo.Context) error {
 	return nil
 }
 
-// IconHandler serves icon for the PDFs.
-func IconHandler(c echo.Context) error {
-	instance := middlewares.GetInstance(c)
-
-	secret := c.Param("secret")
-	fileID, err := vfs.GetStore().GetThumb(instance, secret)
-	if err != nil {
-		return WrapVfsError(err)
-	}
-	if c.Param("file-id") != fileID {
-		return jsonapi.NewError(http.StatusBadRequest, "Wrong download token")
-	}
-
-	doc, err := instance.VFS().FileByID(fileID)
-	if err != nil {
-		return WrapVfsError(err)
-	}
-
-	if err = CheckAntivirusAction(instance, doc, ActionPreview); err != nil {
-		return err
-	}
-
-	return vfs.ServePDFIcon(c.Response(), c.Request(), instance.VFS(), doc)
-}
-
-// PreviewHandler serves preview images for the PDFs.
-func PreviewHandler(c echo.Context) error {
-	instance := middlewares.GetInstance(c)
-
-	secret := c.Param("secret")
-	fileID, err := vfs.GetStore().GetThumb(instance, secret)
-	if err != nil {
-		return WrapVfsError(err)
-	}
-	if c.Param("file-id") != fileID {
-		return jsonapi.NewError(http.StatusBadRequest, "Wrong download token")
-	}
-
-	doc, err := instance.VFS().FileByID(fileID)
-	if err != nil {
-		return WrapVfsError(err)
-	}
-
-	if err = CheckAntivirusAction(instance, doc, ActionPreview); err != nil {
-		return err
-	}
-
-	return vfs.ServePDFPreview(c.Response(), c.Request(), instance.VFS(), doc)
-}
-
 // ThumbnailHandler serves thumbnails of the images/photos
 func ThumbnailHandler(c echo.Context) error {
 	instance := middlewares.GetInstance(c)
@@ -2204,8 +2154,6 @@ func Routes(router *echo.Group) {
 	router.POST("/upload/metadata", UploadMetadataHandler)
 	router.POST("/:file-id/copy", FileCopyHandler)
 
-	router.GET("/:file-id/icon/:secret", IconHandler)
-	router.GET("/:file-id/preview/:secret", PreviewHandler)
 	router.GET("/:file-id/thumbnails/:secret/:format", ThumbnailHandler)
 
 	router.POST("/archive", ArchiveDownloadCreateHandler)

web/files/files.go

@@ -3750,10 +3750,6 @@ func TestFiles(t *testing.T) {
 		data.ValueEqual("id", parentID)
 		data.Value("attributes").Object().ValueEqual("size", "90")
 	})
-
-	t.Run("DeprecatePreviewAndIcon", func(t *testing.T) {
-		testutils.TODO(t, "2026-05-01", "Remove the deprecated preview and icon for PDF files")
-	})
 }
 
 func readFile(fs vfs.VFS, name string) ([]byte, error) {

web/files/files_test.go

@@ -413,10 +413,6 @@ func (f *file) Links() *jsonapi.LinksList {
 			links.Small = "/files/" + f.doc.DocID + "/thumbnails/" + f.thumbSecret + "/small"
 			links.Medium = "/files/" + f.doc.DocID + "/thumbnails/" + f.thumbSecret + "/medium"
 			links.Large = "/files/" + f.doc.DocID + "/thumbnails/" + f.thumbSecret + "/large"
-			if f.doc.Class == "pdf" {
-				links.Icon = "/files/" + f.doc.DocID + "/icon/" + f.thumbSecret
-				links.Preview = "/files/" + f.doc.DocID + "/preview/" + f.thumbSecret
-			}
 		}
 	}
 	return &links