Self-host 015

Scope: main (0.14.1) → dev/0.15, comprising 47 commits.
Author distribution: keven1024/keven (44), TrapStoner (3).

Added

• Introduced a unified configuration model (pkg/models/config.go). Configuration settings, previously scattered across various environment variables, have been consolidated into a strongly-typed Config struct. This struct is organized into seven groups—share, upload, redis, features, site, about, and smtp—with all fields annotated using mapstructure tags.
• Configuration loading and validation (pkg/utils/config.go). Configuration is loaded via viper, supporting default value merging (using mergo) and field validation (using go-playground/validator). Two custom validation rules have been registered: storage_size (for human-readable storage capacities, e.g., 100GiB) and required_en_key_content (ensuring that multi-language content includes an English key). New GetConfig() and SetConfig() functions have been added; all modules (backend, worker, and pkg) have been migrated from GetEnv/GetEnvMap to use GetConfig().
• Hot-reloading of configuration. viper is configured with WatchConfig() and OnConfigChange, allowing for automatic reloading and re-validation whenever the configuration file is modified. Additionally, AutomaticEnv and ExperimentalBindStruct have been enabled.
• Graceful shutdown. The entry points for both the backend and worker have been refactored into a run() int pattern. This implementation utilizes signal.NotifyContext (for SIGINT/SIGTERM signals) in conjunction with echo.StartConfig{GracefulTimeout: 30s} and asynq.Config{ShutdownTimeout: 30s}. Initialization failures now return an exit code of 1 along with an error log, replacing previous panic or log.Fatalf calls. Furthermore, Redis, asynq clients, and the scheduler are now properly shut down using defer. - Route and Middleware Registry. Added internal/route.go (Route + Routes) and internal/middleware.go (Middlewares) to the backend; added internal/route.go and internal/middleware.go to the worker. The main function has been updated to iterate through these registries, and route/middleware definitions have been moved from the package root into the internal/ directory.
• New Scheduler Registry (worker/internal/scheduler.go). Scheduled tasks are now declared via a list of Schedule{Cron, Handle} objects. The file cleanup task file:janitor (scheduled for 0 3 * * *) has been migrated to this registry. Note that the text:translate route is currently commented out in the route table and can be enabled on an as-needed basis.
• Enhanced Tiptap Editor Capabilities. Added a drag handle (DragHandle.vue)—supporting block-level menus (convert, insert below, delete) and language switching for code blocks—as well as Markdown paste confirmation (PasteHandler.ts + isStringMarkdown), mathematical formula support (@tiptap/extension-mathematics + KaTeX), tables (TableKit), lists (ListKit), images (with proportional scaling enabled), cross-block selection (NodeRange, triggered via Cmd on macOS or Ctrl on Windows), and GFM (GitHub Flavored Markdown) parsing.
• Text Statistics. The countWords function now returns an object { length, characters } instead of a single number, with added support for counting emojis (including surrogate pairs). The editor status bar now displays both character and word counts.
• New Multilingual Keys. Added page.editor.markdown and page.editor.tiptap entries across seven languages ​​​​(en, zh-CN, zh-TW, ja, ko, fr, de), covering Markdown paste confirmation prompts, block types, and programming language names.
• Added WebP Icons. - front/public/logo.webp (replaces the 2.03MB logo.png; ~156KB, a 92% reduction). The default icon path is now /logo.webp. The Navbar icon now pulls from the site_icon configuration setting, with a fallback to logo.webp. useSeo now generates the appropriate MIME type for og:image based on the file extension. (by TrapStoner, 42a5222 / 439a6de)
• Real Client IP. The backend is now configured with e.IPExtractor = echo.ExtractIPFromXFFHeader(echo.TrustLoopback(true)). This prevents the system from incorrectly identifying all clients as 127.0.0.1 when running behind Caddy (previously, this caused rate-limiting to treat all clients as a single entity). (by TrapStoner, f0ff278)
• New Unit Tests. Added pkg/utils/config_test.go (covering default value merging, overrides, and validation) and pkg/utils/env_test.go.
• Added an optional btnClass property to ConfirmActionDrawer; the delete button on the share management page now uses the "destructive" style.

Improved

• Removed environment variable-based configuration paths. Deleted GetEnvMap(), InitTestViper(), and EnvOption.ConfigData. Tests now use SetConfig(models.Config{...}) instead; `pkg/utils/test/env_test.gohttps://github.com/TrapStoner)** — 3 commits
• fix(assets): Converted icons to WebP format (-92% file size) and updated the Navbar to load site_icon from the configuration (42a5222)
• chore: Synchronized the default icon path in config.example.yaml (439a6de)
• fix: Reported the actual client IP instead of Caddy’s loopback address, resolving an issue where rate-limiting incorrectly treated all clients as a single entity (f0ff278)

Full Changelog: 0.14.1...0.15.0

0.14.0

Added

• Refactored the share data model to a 1-to-many relationship between shares and files. RedisShareInfo was restructured from a single Data (file ID) + FileName field into a Files []ShareFileData array (each entry containing Id and FileName). The legacy Data and FileName fields are now deprecated, and text shares use a dedicated Text field.
• Multiple files now share a single share link. Uploading several files creates only one share link; share creation validates that all files exist and are in the uploaded state.
• Related operations use a Redis lock (RedisLockKey) for concurrency safety.
• Added single-file download and multi-select archive download. The download endpoint now accepts a file_ids parameter to download only the selected files; a single file is downloaded directly, while multiple files are packed into an archive supporting zip, tar.gz, tar.zst, tar.s2, and tar.snappy formats (defaulting to zip). Temporary archives are cleaned up automatically after download.
• Refactoring a share management page for unified management of file and text shares, displaying share info cards (pickup code, expiration time, etc.).
• Added a delete share feature with a confirmation dialog, backed by a new DELETE /share/:id endpoint.
• Enhanced share validation with expiration checks, a permission-denied error (ErrPermissionDenied), and an invalid share file data error (ErrInvalidShareFileData).
• Added unit tests for file compression and slice handling, and for share data conversion (JsonShareInfoToDomain).

Improved

• Optimized Docker deployment: added Caddy support to the Dockerfile and adjusted port configuration, added the gcompat dependency to the worker image, and streamlined the build process.
• Improved the loading state UI on share pages with enhanced skeleton layouts.
• Improved file compression functions and download error handling, and standardized error message formatting.
• Improved the worker's RunCommand error logging and share task deletion logic.
• Updated the README to reflect Nuxt 4 and the latest feature descriptions.

Dependencies

• Updated frontend dependencies including Tiptap, Vue, axios, dayjs, pixi.js, reka-ui, shadcn, vitest, and vue-tsc.
• Updated Go dependencies including golang.org/x/sys, golang.org/x/text, and related backend/worker modules.
• Added skills-lock.json for skill management.

---

Full Changelog: 0.13.0...0.14.0

New Features

Background Tasks

• File Janitor
  Add a daily background task to automatically clean up orphaned files and expired uploads, preventing leftover files from occupying storage space.

• Asynq Worker Initialization
  Initialize Asynq in the main application and establish the foundation for asynchronous background task processing.

Configuration

• SMTP Configuration
  Add SMTP configuration options to config.example.yaml in preparation for upcoming email notification features.

---

Bug Fixes

• Redis Startup Retry
  Fix backend crashes caused by Redis not being ready during container startup by introducing up to 10 retry attempts with an exponential backoff strategy (300ms → 810ms → 2.2s, capped at 15s).

• CI Release Workflow
  Fix the conditional logic for publishing the edge tag in the GitHub Actions workflow.

---

Improvements

• Request Logging
  Enhance the logger middleware to include HTTP methods and client IP addresses for easier debugging and request tracing.

• Temporary File Handling
  Refactor temporary file cleanup logic and unify the temporary file lifecycle management process.

---

Contributors

Welcome our new contributor @TrapStoner 🎉

• @TrapStoner — Implemented the Redis startup retry mechanism with exponential backoff.

What's Changed

• fix(redis): retry with exponential backoff on startup by @TrapStoner in #42

New Contributors

• @TrapStoner made their first contribution in #42

Full Changelog: 0.11.0...0.12.0

New Features

Notifications

• Implement webhook and email notification services for share events
• Include client IP in notification payload for improved tracking
• Integrate GeoIP functionality into email notifications with region information
• Add structured email template data with locale and webhook support

File Handling

• Add FileIcon components for audio, video, image, and generic file previews with dynamic thumbnail extraction
• Support HEIC image format in file type detection
• Migrate file hash calculation from MD5 to SHA1 for improved security
• Introduce engine selection (native / WASM) for large file hash calculation

Internationalization

• Add language support for Japanese, Korean, French, German, and Traditional Chinese
• Extend i18n translations for notification messages, share types, webhook configuration, and locale switching
• Consolidate i18n logic into pkg/i18n package and fix TOML loading issues

Frontend Components

• Add CopyButton component for unified clipboard functionality
• Add Command / CommandDialog / CommandInput components for command palette
• Add NotifyConfigField component for webhook and email notification configuration
• Add Textarea component for enhanced text input
• Enhance InputField with validation support and error messaging
• Enhance KvInputGroupField and NotifyConfigField with autocomplete and header configuration
• Enhance GlobalDrawer to support async close handling

cURL Import

• Add cURL import functionality in webhook configuration UI
• Integrate sweet-curl-parser to auto-fill request details from pasted cURL commands

Configuration

• Add site_enable_bg property to control background image display
• Add initial spec-driven development configuration file

Infrastructure

• Initialize Redis client with improved context handling
• Implement Asynq task queue initialization and client retrieval
• Add Vitest configuration and unit tests for file hash calculation

Bug Fixes

• Fix URL parsing error in SendEmail that could cause crashes
• Fix missing share information handling in DownloadShare
• Fix JSON marshaling error handling in SetRedis functions
• Fix copy action success message and token handling in FileShareView
• Fix error message font size in InputField and InputGroupField for better readability
• Fix outline-none utility inconsistency in MarkdownRender and Tiptap components
• Fix import path for filePreview type in FilePreviewView
• Fix task scheduling by removing unnecessary duration conversion

Refactoring

• Consolidate i18n logic into pkg/i18n package
• Simplify HTTPBaseResponse by removing interface and using functional options
• Streamline Redis operations in file and share handling with handler functions
• Replace mergo dependency with function-based handlers for data merging
• Improve drawer management by introducing DrawerItem type for better type safety
• Simplify InputGroupField and KvInputGroupField by removing unused state
• Replace background <div> with <p> in layout for improved semantic structure
• Replace MD5 with SHA1 for user avatar generation

Dependencies

• Update @tanstack/vue-query to 5.100.14
• Update markdown-it to 14.2.0
• Update nuxt to 4.4.6
• Add sweet-curl-parser 1.0.4
• Update Go module dependencies across pkg/utils and worker

Infrastructure & DevOps

• Refactor Dockerfile to streamline multi-stage build and update Node.js version
• Add NODE_OPTIONS environment variable for increased memory during build
• Add Caddy configuration (Caddyfile) for service management
• Add email template generation step to Dockerfile build
• Update .gitignore to include config.yaml and pkg/mail/out/

Full Changelog: 0.10.0...0.11.0

Features

• File Upload: FileIcon and FileUpload components now support a size prop and multi-file uploads for improved UX
• File Deduplication: Added deduplication logic in FileUploadField to prevent duplicate files from clipboard and file selection
• Share Drawers: Implemented feature-based action handling in file and text share drawers with dynamic feature support
• About Page: Enhanced About component with feature display and loading states
• Internationalization: Added i18n support for share views
• Redis Distributed Lock: Added Redis lock utility using rueidislock for managing distributed locks

Bug Fixes

• Frontend: Fixed layoutId conversion to string to ensure proper rendering of speed chart items
• SEO: Integrated nuxtApp context for SEO meta handling to ensure correct execution within server environment
• Image Conversion: Fixed JPG format handling by flattening transparent PNGs to a white background before conversion

Refactors

• Redis Client: Migrated from go-redis to rueidis client across multiple models for improved performance
• Redis Lock: Enhanced lock utility with expiration duration support and improved context management
• Redis Stat Updates: Streamlined stat updates using a handler function; improved context management in locking
• Session Management: Implemented session management using Gorilla sessions and streamlined middleware retrieval
• Environment Variables: Updated env var handling to use GetEnvMap for improved type safety with feature extraction
• Frontend Charts: Removed unused chart components and streamlined chart implementation
• FileUpload & Navbar: Updated components for improved code clarity and consistency
• tsconfig.json: Simplified by removing unnecessary compiler options

Dependencies

• Upgraded asynq to v0.26.0, Redis to v9.18.0, and various golang.org/x packages
• Updated frontend dependencies in package.json and pnpm-lock.yaml to latest versions

Chores

• Added .air.toml configuration files for backend and worker to streamline hot-reload development
• Removed service worker implementation to streamline frontend architecture
• Added test.webp image and updated image conversion tests to include WebP format

---