BlueGit

timfa filemanager

Update technical and test indexes

timfa Tim Falken · pushed by timfa

Authored 2026-05-19 · 6 months ago

Hash
5f1bb6c32bcb89e0ac5b52b5925504bdae5b6312
Parent
c16b5859
2 files changed +12 −0
.github/technical-reference.md +11 −0
@@ -47,6 +47,7 @@
47 47 - POST /api/auth/login - Authenticates user by case-insensitive username match and issues token with canonical stored username.
48 48 - GET /api/auth/me - Returns current authenticated user profile.
49 49 - POST /api/auth/logout - Revokes the active session.
50 - POST /api/auth/change-password - Authenticated password change using current-password verification and minimum-length validation.
50 51
51 52 ## server/routes/admin.js
52 53 - POST /api/admin/users - Creates a new user and enforces case-insensitive username uniqueness.
@@ -141,6 +142,7 @@
141 142 ## public/index.html
142 143 - Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
143 144 - Top bar - Places icon-only Refresh to the left of breadcrumb/Home, keeps search input with icon-only search button, and groups actions into Upload/User dropdown triggers.
145 - User menu - Includes a Change Password action and a dedicated change-password modal with current/new/confirm fields.
144 146 - Admin panel - Includes an icon-only global favicon button that opens the shared icon picker modal.
145 147 - Admin panel - Users section includes a conditional orphaned-user-folders subsection that appears only when non-empty orphan folders exist.
146 148 - Admin modal - Includes User Folders controls (user path + per-user size limit) and a dedicated save action for that config.
@@ -173,6 +175,7 @@
173 175 - displayPathWithRootLabel(targetPath, rootPath, rootLabel) - Produces Linux-style root-relative display paths like `/Downloads/A/B` for folder context UI.
174 176 - runGlobalFileSearch() - Executes cross-root fuzzy file search via `/files/search`, swaps the grid into search-results mode, and updates breadcrumb/folder-stats text.
175 177 - 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.
178 - openChangePasswordModal() - Opens the user password modal, validates confirmation/minimum length client-side, and submits to POST /auth/change-password.
176 179 - loadThumbnails() - Registers visible file icons for lazy thumbnail loading (both file thumbnails and folder icons); retries missing cache thumbnails during incremental refresh.
177 180 - 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.
178 181 - loadOneThumbnail(iconEl) - Loads thumbnails from server cache endpoint for images and videos, text snapshots for text files, and badges for other files; marks image/video icons as pending when cache returns 404 and uses direct source SVG thumbnails for SVG files under 1MB.
@@ -246,6 +249,10 @@
246 249 - loadWatchedStatusesForCurrentDir() - Fetches watched states in one bulk POST /files/watched-statuses request per directory (with legacy /files/meta fallback), caches statuses per path, and updates tile overlays quickly.
247 250 - attachMobileLongPress(el, item) - Adds mobile long-press detection on file/folder tiles to open the item sidebar without desktop side effects.
248 251 - beginSidebarLoad() - Aborts in-flight sidebar requests and increments a load token so stale async responses cannot mutate the current sidebar state.
252 - renderItemActionButtons(actions, item) - Shared action renderer used by sidebar and custom context menu so file/folder actions stay identical.
253 - createFolderInCurrentDir() - Shared folder-creation flow used by toolbar and custom context menu.
254 - openItemContextMenu(item, x, y) / openFolderContextMenu(x, y) - Desktop custom right-click menus that replace the native context menu for item and background interactions.
255 - addContextMenuSubmenu(...) / addContextMenuButton(...) - Context-menu builders used for Sort by / Group by submenus and checkbox-style toggle rows.
249 256 - openSidebar(item) - Renders item details/actions in sidebar; roots show alias + original name + usage stats, hide Move To/Delete, keep Rename.
250 257 - openSidebar(item) - Personal user roots display access as private and skip /files/root-access lookups to avoid forbidden noise.
251 258 - openSidebar(item) - Uses abortable metadata/access requests and stale-load guards to prevent race-condition UI duplication when selection changes quickly.
@@ -285,16 +292,20 @@
285 292 - .admin-size-feedback(.ok/.err) - Validation feedback styling for admin user-folder size-limit input.
286 293 - .top-search* + .global-favicon-preview - Topbar file search controls and global favicon preview button styling.
287 294 - .folder-icon-filter - Search input styling for live filtering in the icon-picker modal.
295 - .custom-context-menu* - Desktop context-menu layout with separators and hover-open submenus for folder view options.
288 296
289 297 ## tests/auth.routes.test.js
290 298 - session lifecycle / POST /api/auth/logout revokes active session - Verifies explicit logout invalidates token immediately.
291 299 - session lifecycle / session expires after 1 hour of inactivity - Verifies server-side idle timeout enforcement.
300 - POST /api/auth/change-password / rejects incorrect current password - Verifies password-change validation when current password is wrong.
301 - POST /api/auth/change-password / updates password and invalidates old login credentials - Verifies successful password update and old-password login failure.
292 302
293 303 ## tests/page.load.test.js
294 304 - bootClient() - Boots the app in jsdom and waits until app shell is visible or timeout before assertions.
295 305 - waitFor(dom, predicate, timeoutMs) - Poll helper used by interaction tests to wait for rendered tiles.
296 306 - login overlay uses username and current-password autocomplete tokens - Verifies normal sign-in mode exposes browser-friendly login autocomplete attributes.
297 307 - first-run setup uses new-password autocomplete token - Verifies setup mode switches the password field to the browser-friendly new-password token.
308 - desktop right-click uses custom context menu for files and folder background - Verifies desktop context menu replacement and folder-view option entries.
298 309 - expanded file preview shows a Share button next to Download - Verifies expanded preview UI includes both actions inside a dedicated footer below the preview content.
299 310 - expanded STL preview falls back gracefully when WebGL is unavailable - Verifies STL preview path shows a clear fallback message when WebGL contexts are unavailable.
300 311 - expanded video preview uses a stream session and video.js - Verifies streamed video preview uses the server-backed HLS session and registers subtitle tracks with video.js.
@@ -47,6 +47,7 @@
47- POST /api/auth/login - Authenticates user by case-insensitive username match and issues token with canonical stored username.
47- POST /api/auth/login - Authenticates user by case-insensitive username match and issues token with canonical stored username.
48- GET /api/auth/me - Returns current authenticated user profile.
48- GET /api/auth/me - Returns current authenticated user profile.
49- POST /api/auth/logout - Revokes the active session.
49- POST /api/auth/logout - Revokes the active session.
50- POST /api/auth/change-password - Authenticated password change using current-password verification and minimum-length validation.
50
51
51## server/routes/admin.js
52## server/routes/admin.js
52- POST /api/admin/users - Creates a new user and enforces case-insensitive username uniqueness.
53- POST /api/admin/users - Creates a new user and enforces case-insensitive username uniqueness.
@@ -141,6 +142,7 @@
141## public/index.html
142## public/index.html
142- Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
143- Auth form - Login/setup form uses username plus mode-specific password autocomplete tokens so browser password managers behave correctly.
143- Top bar - Places icon-only Refresh to the left of breadcrumb/Home, keeps search input with icon-only search button, and groups actions into Upload/User dropdown triggers.
144- Top bar - Places icon-only Refresh to the left of breadcrumb/Home, keeps search input with icon-only search button, and groups actions into Upload/User dropdown triggers.
145- User menu - Includes a Change Password action and a dedicated change-password modal with current/new/confirm fields.
144- Admin panel - Includes an icon-only global favicon button that opens the shared icon picker modal.
146- Admin panel - Includes an icon-only global favicon button that opens the shared icon picker modal.
145- Admin panel - Users section includes a conditional orphaned-user-folders subsection that appears only when non-empty orphan folders exist.
147- Admin panel - Users section includes a conditional orphaned-user-folders subsection that appears only when non-empty orphan folders exist.
146- Admin modal - Includes User Folders controls (user path + per-user size limit) and a dedicated save action for that config.
148- Admin modal - Includes User Folders controls (user path + per-user size limit) and a dedicated save action for that config.
@@ -173,6 +175,7 @@
173- displayPathWithRootLabel(targetPath, rootPath, rootLabel) - Produces Linux-style root-relative display paths like `/Downloads/A/B` for folder context UI.
175- displayPathWithRootLabel(targetPath, rootPath, rootLabel) - Produces Linux-style root-relative display paths like `/Downloads/A/B` for folder context UI.
174- runGlobalFileSearch() - Executes cross-root fuzzy file search via `/files/search`, swaps the grid into search-results mode, and updates breadcrumb/folder-stats text.
176- runGlobalFileSearch() - Executes cross-root fuzzy file search via `/files/search`, swaps the grid into search-results mode, and updates breadcrumb/folder-stats text.
175- 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.
177- 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.
178- openChangePasswordModal() - Opens the user password modal, validates confirmation/minimum length client-side, and submits to POST /auth/change-password.
176- loadThumbnails() - Registers visible file icons for lazy thumbnail loading (both file thumbnails and folder icons); retries missing cache thumbnails during incremental refresh.
179- loadThumbnails() - Registers visible file icons for lazy thumbnail loading (both file thumbnails and folder icons); retries missing cache thumbnails during incremental refresh.
177- 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.
180- 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.
178- loadOneThumbnail(iconEl) - Loads thumbnails from server cache endpoint for images and videos, text snapshots for text files, and badges for other files; marks image/video icons as pending when cache returns 404 and uses direct source SVG thumbnails for SVG files under 1MB.
181- loadOneThumbnail(iconEl) - Loads thumbnails from server cache endpoint for images and videos, text snapshots for text files, and badges for other files; marks image/video icons as pending when cache returns 404 and uses direct source SVG thumbnails for SVG files under 1MB.
@@ -246,6 +249,10 @@
246- loadWatchedStatusesForCurrentDir() - Fetches watched states in one bulk POST /files/watched-statuses request per directory (with legacy /files/meta fallback), caches statuses per path, and updates tile overlays quickly.
249- loadWatchedStatusesForCurrentDir() - Fetches watched states in one bulk POST /files/watched-statuses request per directory (with legacy /files/meta fallback), caches statuses per path, and updates tile overlays quickly.
247- attachMobileLongPress(el, item) - Adds mobile long-press detection on file/folder tiles to open the item sidebar without desktop side effects.
250- attachMobileLongPress(el, item) - Adds mobile long-press detection on file/folder tiles to open the item sidebar without desktop side effects.
248- beginSidebarLoad() - Aborts in-flight sidebar requests and increments a load token so stale async responses cannot mutate the current sidebar state.
251- beginSidebarLoad() - Aborts in-flight sidebar requests and increments a load token so stale async responses cannot mutate the current sidebar state.
252- renderItemActionButtons(actions, item) - Shared action renderer used by sidebar and custom context menu so file/folder actions stay identical.
253- createFolderInCurrentDir() - Shared folder-creation flow used by toolbar and custom context menu.
254- openItemContextMenu(item, x, y) / openFolderContextMenu(x, y) - Desktop custom right-click menus that replace the native context menu for item and background interactions.
255- addContextMenuSubmenu(...) / addContextMenuButton(...) - Context-menu builders used for Sort by / Group by submenus and checkbox-style toggle rows.
249- openSidebar(item) - Renders item details/actions in sidebar; roots show alias + original name + usage stats, hide Move To/Delete, keep Rename.
256- openSidebar(item) - Renders item details/actions in sidebar; roots show alias + original name + usage stats, hide Move To/Delete, keep Rename.
250- openSidebar(item) - Personal user roots display access as private and skip /files/root-access lookups to avoid forbidden noise.
257- openSidebar(item) - Personal user roots display access as private and skip /files/root-access lookups to avoid forbidden noise.
251- openSidebar(item) - Uses abortable metadata/access requests and stale-load guards to prevent race-condition UI duplication when selection changes quickly.
258- openSidebar(item) - Uses abortable metadata/access requests and stale-load guards to prevent race-condition UI duplication when selection changes quickly.
@@ -285,16 +292,20 @@
285- .admin-size-feedback(.ok/.err) - Validation feedback styling for admin user-folder size-limit input.
292- .admin-size-feedback(.ok/.err) - Validation feedback styling for admin user-folder size-limit input.
286- .top-search* + .global-favicon-preview - Topbar file search controls and global favicon preview button styling.
293- .top-search* + .global-favicon-preview - Topbar file search controls and global favicon preview button styling.
287- .folder-icon-filter - Search input styling for live filtering in the icon-picker modal.
294- .folder-icon-filter - Search input styling for live filtering in the icon-picker modal.
295- .custom-context-menu* - Desktop context-menu layout with separators and hover-open submenus for folder view options.
288
296
289## tests/auth.routes.test.js
297## tests/auth.routes.test.js
290- session lifecycle / POST /api/auth/logout revokes active session - Verifies explicit logout invalidates token immediately.
298- session lifecycle / POST /api/auth/logout revokes active session - Verifies explicit logout invalidates token immediately.
291- session lifecycle / session expires after 1 hour of inactivity - Verifies server-side idle timeout enforcement.
299- session lifecycle / session expires after 1 hour of inactivity - Verifies server-side idle timeout enforcement.
300- POST /api/auth/change-password / rejects incorrect current password - Verifies password-change validation when current password is wrong.
301- POST /api/auth/change-password / updates password and invalidates old login credentials - Verifies successful password update and old-password login failure.
292
302
293## tests/page.load.test.js
303## tests/page.load.test.js
294- bootClient() - Boots the app in jsdom and waits until app shell is visible or timeout before assertions.
304- bootClient() - Boots the app in jsdom and waits until app shell is visible or timeout before assertions.
295- waitFor(dom, predicate, timeoutMs) - Poll helper used by interaction tests to wait for rendered tiles.
305- waitFor(dom, predicate, timeoutMs) - Poll helper used by interaction tests to wait for rendered tiles.
296- login overlay uses username and current-password autocomplete tokens - Verifies normal sign-in mode exposes browser-friendly login autocomplete attributes.
306- login overlay uses username and current-password autocomplete tokens - Verifies normal sign-in mode exposes browser-friendly login autocomplete attributes.
297- first-run setup uses new-password autocomplete token - Verifies setup mode switches the password field to the browser-friendly new-password token.
307- first-run setup uses new-password autocomplete token - Verifies setup mode switches the password field to the browser-friendly new-password token.
308- desktop right-click uses custom context menu for files and folder background - Verifies desktop context menu replacement and folder-view option entries.
298- expanded file preview shows a Share button next to Download - Verifies expanded preview UI includes both actions inside a dedicated footer below the preview content.
309- expanded file preview shows a Share button next to Download - Verifies expanded preview UI includes both actions inside a dedicated footer below the preview content.
299- expanded STL preview falls back gracefully when WebGL is unavailable - Verifies STL preview path shows a clear fallback message when WebGL contexts are unavailable.
310- expanded STL preview falls back gracefully when WebGL is unavailable - Verifies STL preview path shows a clear fallback message when WebGL contexts are unavailable.
300- expanded video preview uses a stream session and video.js - Verifies streamed video preview uses the server-backed HLS session and registers subtitle tracks with video.js.
311- expanded video preview uses a stream session and video.js - Verifies streamed video preview uses the server-backed HLS session and registers subtitle tracks with video.js.
.github/tests.md +1 −0
@@ -24,6 +24,7 @@
24 24 - `POST /api/auth/setup`
25 25 - `POST /api/auth/login`
26 26 - `session lifecycle`
27 - `POST /api/auth/change-password`
27 28
28 29 ---
29 30
@@ -24,6 +24,7 @@
24- `POST /api/auth/setup`
24- `POST /api/auth/setup`
25- `POST /api/auth/login`
25- `POST /api/auth/login`
26- `session lifecycle`
26- `session lifecycle`
27- `POST /api/auth/change-password`
27
28
28---
29---
29
30