# Technical Reference ## server/db.js - initDb() - Initializes SQLite schema for users, file metadata, and auth_sessions (idle timeout/revocation support). - getDb() - Returns singleton DB handle with WAL and foreign key pragmas. - closeDb() - Closes singleton DB handle to release file locks. ## server/auth.js - createToken(username, req, fingerprint) - Creates JWT bound to IP/region/fingerprint and linked to a DB-backed session id. - requireAuth(req, res, next) - Verifies JWT + binding + session row + 1-hour idle timeout, updates last_seen_at, and attaches req.user. - requireAdmin(req, res, next) - Requires authenticated admin user. - revokeSession(sessionId) - Revokes a session row so future token use fails immediately. - getClientIp(req) - Normalizes request IP (including IPv4-mapped IPv6 loopback cases). - getRegion(ip) - Derives coarse region binding from geoip lookup or local fallback. - SESSION_IDLE_TIMEOUT_MS - Server-enforced idle timeout window (1 hour). ## server/routes/auth.js - extractCredentials(body) - Accepts encrypted payloads and compatibility plaintext payloads for login/setup. - makeAuthResponse(token, clientPublicKey) - Returns encrypted token when client key exists, plaintext token otherwise. - POST /api/auth/setup - Creates first admin and issues token. - POST /api/auth/login - Authenticates user and issues token. - GET /api/auth/me - Returns current authenticated user profile. - POST /api/auth/logout - Revokes the active session. ## public/app.js - getOrCreateClientBindingId() - Creates/loads a persistent local browser binding id used in auth fingerprint derivation. - getFingerprint() - Builds a stable fingerprint from binding id + stable browser properties (not viewport metrics) to avoid false session invalidation on UI/window-state changes. - saveSessionState() - Persists token, selected path, and last operation timestamp in localStorage. - loadSessionState() - Restores persisted state only when the last operation is within the 1-hour local idle window. - api(method, path, body, opts) - Central API caller; refreshes local session timestamp on successful authenticated calls. - performLogout() - Explicit logout path that revokes server session and clears local session state. - initAuth() - Restores prior session when valid and auto-logins without credential prompt. - showConfirm(title, message) - In-page confirm dialog; returns Promise. Use instead of window.confirm(). - showPrompt(title, message, defaultValue) - In-page text-input dialog; returns Promise. Use instead of window.prompt(). - showOverwrite(filename) - In-page overwrite-decision dialog for file conflicts; returns Promise<'yes'|'no'|'all'|'none'>. - loadThumbnails() - Loads per-file image thumbnails into file SVG icons after grid rendering. - loadOneThumbnail(iconEl) - Injects clipped in-icon thumbnails: real previews for image/video/text where feasible and generated badges for other file types. - getThumbnailKind(name) - Classifies files into thumbnail strategy buckets (image/video/text/audio/pdf/badge). - buildThumbnailSource(item, blob, kind) - Produces thumbnail image source (blob URL/data URL) for icon injection. - detectCodeLanguage(name, mime) - Determines preview language for text/script files by MIME and extension. - prettyPrintCode(raw, lang) - Best-effort formatter for JSON/markup/script previews before rendering. - highlightCode(raw, lang) - Escapes and syntax-highlights preview text into HTML spans. - fileAccentColor(name) - Returns canonical file-type accent color used by icon strokes and preview sheet outline. - animatePreviewOpen(sourceSvgEl, sheetEl) - Animates a cloned file icon from its tile position into the full preview sheet. - openFolderSidebar() - Persistent sidebar fallback view that shows current folder/root overview when no item is selected. - fetchFileBlob(item) - Downloads a file as Blob with auth headers for preview/download flows. - downloadOrView(item) - Opens the in-app file-preview overlay and attaches bottom download action. - renderPreviewBody(item, blob, objectUrl) - Renders preview content (image/video/audio/pdf/text) or unsupported message. - closePreview() - Closes preview overlay and revokes active preview object URL. - isInlinePreviewableBlob(blob, name) - Determines if a blob can be previewed inline by MIME/extension. - makeFileItem(item) - Builds a .file-item element; sets data-isdir attribute on folders and calls makeDraggable(el, item) from drag-move.js. ## public/drag-move.js - makeDraggable(el, item) - Attaches pointerdown to a .file-item; starts drag after threshold movement. Depends on: api(), canWrite(), navigateTo(), STATE, closeSidebar(), toast() from app.js. - (internal) _beginDrag(e, el, item) - Creates ghost clone, dims source, records drag state. - (internal) _moveDrag(e) - Moves ghost, hit-tests .file-item[data-isdir] targets, toggles drop-target class. - (internal) _endDrag(e) - On valid target: runs drop animation then calls POST /api/files/move, refreshes dir. Otherwise snap-back. - (internal) _cleanupDrag() - Removes ghost, clears classes, resets _drag state. ## public/drag-move.css - .file-item.drag-source - Dims source item during drag. - .file-item.drop-target - Glows folder icon when drag hovers over it. - .drag-ghost - Fixed-position cursor-following clone. - @keyframes drag-rise-spin-fall - Ghost rises, spins, falls/scales into folder on drop. - @keyframes folder-bounce - Target folder bounces down then back on accept. - @keyframes drag-snap-back - Ghost snaps back to origin on abort. ## tests/auth.routes.test.js - session lifecycle / POST /api/auth/logout revokes active session - Verifies explicit logout invalidates token immediately. - session lifecycle / session expires after 1 hour of inactivity - Verifies server-side idle timeout enforcement.