BlueGit

timfa filemanager

Update technical and test indexes for search/favicon

timfa Tim Falken · pushed by timfa

Authored 2026-05-17 · 6 months ago

Hash
8c639b7909602fb74ebba79d9340c7d8ad5b7d1c
Parent
7434786a
2 files changed +13 −3
.github/technical-reference.md +11 −0
@@ -72,6 +72,10 @@
72 72 - GET /api/files/folder-images - Returns files inside a directory (recursive) that already have a cached thumbnail (including video thumbnails when cached).
73 73 - GET /api/files/folder-icon - Returns the current icon source file for a folder ({icon:{filePath}} or {icon:null}); explicit assignment takes priority over auto-first.
74 74 - POST /api/files/folder-icon - Sets or clears a folder's explicit icon assignment; imagePath must have a cached thumbnail; write access required.
75 - GET /api/files/search - Fuzzy-searches all readable roots (and personal folder when configured) for files, returning ranked matches with path metadata.
76 - GET /api/files/global-favicon-image - Publicly serves the configured global favicon thumbnail file so browsers can load `<link rel="icon">` without auth headers.
77 - GET /api/files/global-favicon - Returns the configured global favicon source file path ({favicon:{filePath}} or {favicon:null}).
78 - POST /api/files/global-favicon - Admin-only route that sets or clears the global favicon source image; image must have a cached thumbnail.
75 79 - GET /api/files/download-zip?dir=<absolute-path> - Authenticated. Streams the directory as a zip archive; caches the zip for up to 1 day in zip-cache/.
76 80 - makeTempUploadPath(dir, originalName) - Builds a hidden per-upload staging filename in the target directory for multipart uploads.
77 81 - unlinkIfExists(targetPath, cb) - Removes a file during upload cleanup while ignoring already-missing temp files.
@@ -128,6 +132,7 @@
128 132
129 133 ## public/index.html
130 134 - Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
135 - Top bar - Includes global file search input/button controls plus an admin-only global favicon button.
131 136 - Admin modal - Includes User Folders controls (user path + per-user size limit) and a dedicated save action for that config.
132 137 - Import map - Maps `three` and `three/addons/` to local vendored modules for client-side STL/OBJ previews.
133 138
@@ -154,6 +159,7 @@
154 159 - updateAdminSizeFeedback(rawValue) - Validates size input and updates admin hint text/classes with parsed byte preview.
155 160 - relativePathFromRoot(targetPath, rootPath) - Produces a root-relative path string for sidebar folder context display.
156 161 - displayPathWithRootLabel(targetPath, rootPath, rootLabel) - Produces Linux-style root-relative display paths like `/Downloads/A/B` for folder context UI.
162 - runGlobalFileSearch() - Executes cross-root fuzzy file search via `/files/search`, swaps the grid into search-results mode, and updates breadcrumb/folder-stats text.
157 163 - openShareModal(item) - Opens the Delen (share) popup, calls POST /api/share/create, shows the 24-hour URL with a copy button and OK to dismiss.
158 164 - loadThumbnails() - Registers visible file icons for lazy thumbnail loading (both file thumbnails and folder icons); retries missing cache thumbnails during incremental refresh.
159 165 - loadOneThumbnail(iconEl) - Loads thumbnails from server cache endpoint for images, text snapshots for text files, and badges for other files; marks image icons as pending when cache returns 404 and uses direct source SVG thumbnails for SVG files under 1MB.
@@ -163,6 +169,9 @@
163 169 - loadOneFolderIcon(iconEl) - Fetches /api/files/folder-icon then the thumbnail blob and overlays it inside the folder SVG; no-op if no icon available.
164 170 - applyFolderThumbnail(iconEl, srcUrl) - Injects an SVG <image> element clipped to the folder outline path into the folder's icon SVG.
165 171 - openFolderIconPicker(item) - Opens the folder icon picker modal; shows cached-thumbnail files from the folder (including video thumbnails); allows selection, clearing, and cancellation.
172 - openIconPickerModal(options) - Shared icon-picker modal used by folder-icon and global-favicon flows; includes live thumbnail-name filtering.
173 - openGlobalFaviconPicker() - Opens the shared icon picker for the current folder and sets/clears global favicon via `/files/global-favicon`.
174 - refreshGlobalFavicon() - Reads `/files/global-favicon`, updates topbar preview button, and applies/removes the page `<link rel="icon">` URL.
166 175 - refreshAfterIconChange(item) - Resets and reloads the folder icon in both the grid tile and sidebar after set/clear operations.
167 176 - disconnectFolderIconObserver() - Disconnects and clears the folder icon IntersectionObserver on grid rebuild.
168 177 - getThumbnailKind(name) - Classifies files into image/text/badge thumbnail strategies.
@@ -254,6 +263,8 @@
254 263 ## public/style.css
255 264 - #sidebar-duplicates + related classes - Sidebar duplicate-file list styling with truncation and hover feedback.
256 265 - .admin-size-feedback(.ok/.err) - Validation feedback styling for admin user-folder size-limit input.
266 - .top-search* + .global-favicon-preview - Topbar file search controls and global favicon preview button styling.
267 - .folder-icon-filter - Search input styling for live filtering in the icon-picker modal.
257 268
258 269 ## tests/auth.routes.test.js
259 270 - session lifecycle / POST /api/auth/logout revokes active session - Verifies explicit logout invalidates token immediately.
@@ -72,6 +72,10 @@
72- GET /api/files/folder-images - Returns files inside a directory (recursive) that already have a cached thumbnail (including video thumbnails when cached).
72- GET /api/files/folder-images - Returns files inside a directory (recursive) that already have a cached thumbnail (including video thumbnails when cached).
73- GET /api/files/folder-icon - Returns the current icon source file for a folder ({icon:{filePath}} or {icon:null}); explicit assignment takes priority over auto-first.
73- GET /api/files/folder-icon - Returns the current icon source file for a folder ({icon:{filePath}} or {icon:null}); explicit assignment takes priority over auto-first.
74- POST /api/files/folder-icon - Sets or clears a folder's explicit icon assignment; imagePath must have a cached thumbnail; write access required.
74- POST /api/files/folder-icon - Sets or clears a folder's explicit icon assignment; imagePath must have a cached thumbnail; write access required.
75- GET /api/files/search - Fuzzy-searches all readable roots (and personal folder when configured) for files, returning ranked matches with path metadata.
76- GET /api/files/global-favicon-image - Publicly serves the configured global favicon thumbnail file so browsers can load `<link rel="icon">` without auth headers.
77- GET /api/files/global-favicon - Returns the configured global favicon source file path ({favicon:{filePath}} or {favicon:null}).
78- POST /api/files/global-favicon - Admin-only route that sets or clears the global favicon source image; image must have a cached thumbnail.
75- GET /api/files/download-zip?dir=<absolute-path> - Authenticated. Streams the directory as a zip archive; caches the zip for up to 1 day in zip-cache/.
79- GET /api/files/download-zip?dir=<absolute-path> - Authenticated. Streams the directory as a zip archive; caches the zip for up to 1 day in zip-cache/.
76- makeTempUploadPath(dir, originalName) - Builds a hidden per-upload staging filename in the target directory for multipart uploads.
80- makeTempUploadPath(dir, originalName) - Builds a hidden per-upload staging filename in the target directory for multipart uploads.
77- unlinkIfExists(targetPath, cb) - Removes a file during upload cleanup while ignoring already-missing temp files.
81- unlinkIfExists(targetPath, cb) - Removes a file during upload cleanup while ignoring already-missing temp files.
@@ -128,6 +132,7 @@
128
132
129## public/index.html
133## public/index.html
130- Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
134- Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
135- Top bar - Includes global file search input/button controls plus an admin-only global favicon button.
131- Admin modal - Includes User Folders controls (user path + per-user size limit) and a dedicated save action for that config.
136- Admin modal - Includes User Folders controls (user path + per-user size limit) and a dedicated save action for that config.
132- Import map - Maps `three` and `three/addons/` to local vendored modules for client-side STL/OBJ previews.
137- Import map - Maps `three` and `three/addons/` to local vendored modules for client-side STL/OBJ previews.
133
138
@@ -154,6 +159,7 @@
154- updateAdminSizeFeedback(rawValue) - Validates size input and updates admin hint text/classes with parsed byte preview.
159- updateAdminSizeFeedback(rawValue) - Validates size input and updates admin hint text/classes with parsed byte preview.
155- relativePathFromRoot(targetPath, rootPath) - Produces a root-relative path string for sidebar folder context display.
160- relativePathFromRoot(targetPath, rootPath) - Produces a root-relative path string for sidebar folder context display.
156- displayPathWithRootLabel(targetPath, rootPath, rootLabel) - Produces Linux-style root-relative display paths like `/Downloads/A/B` for folder context UI.
161- displayPathWithRootLabel(targetPath, rootPath, rootLabel) - Produces Linux-style root-relative display paths like `/Downloads/A/B` for folder context UI.
162- runGlobalFileSearch() - Executes cross-root fuzzy file search via `/files/search`, swaps the grid into search-results mode, and updates breadcrumb/folder-stats text.
157- openShareModal(item) - Opens the Delen (share) popup, calls POST /api/share/create, shows the 24-hour URL with a copy button and OK to dismiss.
163- openShareModal(item) - Opens the Delen (share) popup, calls POST /api/share/create, shows the 24-hour URL with a copy button and OK to dismiss.
158- loadThumbnails() - Registers visible file icons for lazy thumbnail loading (both file thumbnails and folder icons); retries missing cache thumbnails during incremental refresh.
164- loadThumbnails() - Registers visible file icons for lazy thumbnail loading (both file thumbnails and folder icons); retries missing cache thumbnails during incremental refresh.
159- loadOneThumbnail(iconEl) - Loads thumbnails from server cache endpoint for images, text snapshots for text files, and badges for other files; marks image icons as pending when cache returns 404 and uses direct source SVG thumbnails for SVG files under 1MB.
165- loadOneThumbnail(iconEl) - Loads thumbnails from server cache endpoint for images, text snapshots for text files, and badges for other files; marks image icons as pending when cache returns 404 and uses direct source SVG thumbnails for SVG files under 1MB.
@@ -163,6 +169,9 @@
163- loadOneFolderIcon(iconEl) - Fetches /api/files/folder-icon then the thumbnail blob and overlays it inside the folder SVG; no-op if no icon available.
169- loadOneFolderIcon(iconEl) - Fetches /api/files/folder-icon then the thumbnail blob and overlays it inside the folder SVG; no-op if no icon available.
164- applyFolderThumbnail(iconEl, srcUrl) - Injects an SVG <image> element clipped to the folder outline path into the folder's icon SVG.
170- applyFolderThumbnail(iconEl, srcUrl) - Injects an SVG <image> element clipped to the folder outline path into the folder's icon SVG.
165- openFolderIconPicker(item) - Opens the folder icon picker modal; shows cached-thumbnail files from the folder (including video thumbnails); allows selection, clearing, and cancellation.
171- openFolderIconPicker(item) - Opens the folder icon picker modal; shows cached-thumbnail files from the folder (including video thumbnails); allows selection, clearing, and cancellation.
172- openIconPickerModal(options) - Shared icon-picker modal used by folder-icon and global-favicon flows; includes live thumbnail-name filtering.
173- openGlobalFaviconPicker() - Opens the shared icon picker for the current folder and sets/clears global favicon via `/files/global-favicon`.
174- refreshGlobalFavicon() - Reads `/files/global-favicon`, updates topbar preview button, and applies/removes the page `<link rel="icon">` URL.
166- refreshAfterIconChange(item) - Resets and reloads the folder icon in both the grid tile and sidebar after set/clear operations.
175- refreshAfterIconChange(item) - Resets and reloads the folder icon in both the grid tile and sidebar after set/clear operations.
167- disconnectFolderIconObserver() - Disconnects and clears the folder icon IntersectionObserver on grid rebuild.
176- disconnectFolderIconObserver() - Disconnects and clears the folder icon IntersectionObserver on grid rebuild.
168- getThumbnailKind(name) - Classifies files into image/text/badge thumbnail strategies.
177- getThumbnailKind(name) - Classifies files into image/text/badge thumbnail strategies.
@@ -254,6 +263,8 @@
254## public/style.css
263## public/style.css
255- #sidebar-duplicates + related classes - Sidebar duplicate-file list styling with truncation and hover feedback.
264- #sidebar-duplicates + related classes - Sidebar duplicate-file list styling with truncation and hover feedback.
256- .admin-size-feedback(.ok/.err) - Validation feedback styling for admin user-folder size-limit input.
265- .admin-size-feedback(.ok/.err) - Validation feedback styling for admin user-folder size-limit input.
266- .top-search* + .global-favicon-preview - Topbar file search controls and global favicon preview button styling.
267- .folder-icon-filter - Search input styling for live filtering in the icon-picker modal.
257
268
258## tests/auth.routes.test.js
269## tests/auth.routes.test.js
259- session lifecycle / POST /api/auth/logout revokes active session - Verifies explicit logout invalidates token immediately.
270- session lifecycle / POST /api/auth/logout revokes active session - Verifies explicit logout invalidates token immediately.
.github/tests.md +2 −3
@@ -44,6 +44,8 @@
44 44 - `GET /api/files/thumbnail`
45 45 - `GET /api/files/root-access`
46 46 - `folder icon endpoints`
47 - `file search endpoint`
48 - `global favicon endpoints`
47 49 - `GET /api/files/download-zip`
48 50 - `video streaming routes`
49 51 - `SHA-256 hashing and duplicate detection`
@@ -52,7 +54,6 @@
52 54
53 55 ## `test/image-subtitles.test.js`
54 56 - `image subtitle option parsing`
55 - `prune calculates drop threshold as end plus duration plus 30 seconds`
56 57
57 58 ---
58 59
@@ -84,7 +85,5 @@
84 85
85 86 ## `test/video-stream.test.js`
86 87 - `video stream bootstrap`
87 - `sendVideoStreamAsset prunes old segment files after playback moves far ahead`
88 - `createVideoStreamSession reuses one transcode for concurrent viewers of the same file`
89 88
90 89 ---
@@ -44,6 +44,8 @@
44- `GET /api/files/thumbnail`
44- `GET /api/files/thumbnail`
45- `GET /api/files/root-access`
45- `GET /api/files/root-access`
46- `folder icon endpoints`
46- `folder icon endpoints`
47- `file search endpoint`
48- `global favicon endpoints`
47- `GET /api/files/download-zip`
49- `GET /api/files/download-zip`
48- `video streaming routes`
50- `video streaming routes`
49- `SHA-256 hashing and duplicate detection`
51- `SHA-256 hashing and duplicate detection`
@@ -52,7 +54,6 @@
52
54
53## `test/image-subtitles.test.js`
55## `test/image-subtitles.test.js`
54- `image subtitle option parsing`
56- `image subtitle option parsing`
55- `prune calculates drop threshold as end plus duration plus 30 seconds`
56
57
57---
58---
58
59
@@ -84,7 +85,5 @@
84
85
85## `test/video-stream.test.js`
86## `test/video-stream.test.js`
86- `video stream bootstrap`
87- `video stream bootstrap`
87- `sendVideoStreamAsset prunes old segment files after playback moves far ahead`
88- `createVideoStreamSession reuses one transcode for concurrent viewers of the same file`
89
88
90---
89---