Vormia Laravel Package

Added

• vormia:migrate-api-routes — focused production command to clear route/config caches, enable VORMIA_REGISTER_API_ROUTES, remove duplicate /api/v1 Vormia auth routes from the host routes/api.php, and update the Postman collection after upgrading

Changed

• Breaking: API auth prefix — login, logout, and current-user endpoints moved from /api/v1/* to /api/vrm/* so all Vormia API routes share one prefix and no longer conflict with host-app /api/v1 versioning

Added

• MediaForge fluent URL builder: MediaForge::url($pathOrUrl, $disk = null) now returns a builder that can generate:
  • Public URLs via ->public()
  • Signed temporary URLs via ->private() (prefers temporaryUrl() when supported)
  • Flexible expiry helpers: ->seconds(), ->minutes(), ->hours(), ->days(), ->years(), and ->expiresAt(...)
• Signed URL default lifetime: VORMIA_MEDIAFORGE_PREVIEW_PERIOD (seconds)
  • Missing key: defaults to 86400 (24h)
  • Present but empty (VORMIA_MEDIAFORGE_PREVIEW_PERIOD=): defaults to 3600 (1h)

Changed

• Breaking: MediaForge upload return value: MediaForge::upload(...)->run() and MediaForge::uploadFile(...)->run() now return a storage path/key by default (instead of sometimes returning a URL).
• Installer env block (vormia:install): now includes
  • VORMIA_MEDIAFORGE_STORAGE_RULE=vormia
  • VORMIA_MEDIAFORGE_PREVIEW_PERIOD=86400
• MediaForge preview helper: MediaForge::previewUrl(...) remains as a compatibility wrapper, implemented via the URL builder.

Added

• Non-image file uploads in MediaForge: Added uploadFile() for uploading raw files (PDFs, docs, zips, etc.) without image processing
• MediaForge upload raw-file mode: Enhanced upload() with an isFile() flag to treat uploads as raw files and skip image operations

Changed

• Documentation: Updated MediaForge docs with examples and guidance for non-image uploads
• Tests: Added coverage for uploading non-image files and verifying storage behavior

Added

• MediaForge URL helpers: New utilities for turning MediaForge outputs into browser-friendly URLs
  • MediaForge::url($urlOrPath, $disk = null) to normalize a MediaForge run() return value (URL-or-path) into a usable URL when possible
  • MediaForge::previewUrl($urlOrPath, $disk = null, $expiresAt = null, array $options = []) to generate previewable URLs, including signed temporary URLs when supported by the disk
• MediaForge proxy preview route (optional): When VORMIA_MEDIAFORGE_PREVIEW_MODE=proxy, Vormia exposes GET /api/vrm/media/preview?disk=...&path=... to stream files for previewing from disks that don’t support url()/temporaryUrl() reliably
• MediaForge URL passthrough config: VORMIA_MEDIAFORGE_URL_PASSTHROUGH controls whether MediaForge::url() returns existing http(s)/data: inputs unchanged

Changed

• Documentation: Expanded MediaForge docs around “URL-or-path” return values, S3/remote disks, and failure handling

Added

• MediaForge storage rule + date folders: New options to control how MediaForge writes files
  • Supports a YYYY/MM/DD folder structure via useDateFolders()
  • Supports switching between Laravel filesystem disks and legacy webroot behavior via a storage rule

Changed

• Documentation: Updated release notes for v5.1.3 with improved two-factor migration guidance

Added

• vormia:uninstall: New Artisan command to fully remove Vormia from an application
  • Removes Vormia config, stubs, and public assets
  • Cleans Vormia entries from bootstrap/app.php and bootstrap/providers.php
  • Strips VORMIA_* from .env and .env.example
  • Reverts Vormia CSS/JS in resources/css/app.css and resources/js/app.js
  • Drops all Vormia database tables (vrm_*)
  • Uninstalls Vormia-related npm packages (jquery, flatpickr, select2, sweetalert2)
  • Clears caches via optimize:clear
  • Use --force to skip confirmation prompt

Changed

• Version patch release.

Fixed

• PSR-4 Autoloading Compliance: Fixed PSR-4 autoloading warnings for stub files
  • Excluded src/stubs/ directory from Composer autoloading
  • Stub files are template files with App\ namespaces meant for Laravel applications
  • These files should not be autoloaded from the package itself
  • Resolves warnings: Class src\stubs\Controllers\... does not comply with psr-4 autoloading standard

Technical

• Composer Configuration: Added exclude-from-classmap to composer.json autoload section
  • Prevents Composer from scanning stub files during autoload generation
  • Maintains proper PSR-4 compliance for package classes

Added

• RoleSeeder: New database seeder for initial role setup
  • Automatically creates three default roles: Super Admin, Admin, and Member
  • Seeder is copied to database/seeders during package installation and updates
  • Includes proper role configuration with authority levels and module assignments
  • Seeder follows Laravel conventions and uses the Vrm\Role model

Changed

• Installation Process: Enhanced to include seeder file copying
  • Seeders are now automatically copied during vormia:install command
  • Seeders are updated during vormia:update command
  • Follows the same pattern as migrations for consistency

Documentation

• Seeder Integration: Added RoleSeeder to package stubs for automatic distribution

Added

• MediaForge Background Fill Color: Resize operations now support background fill color when maintaining aspect ratio
  • Creates exact dimensions with image centered on colored background
  • Empty areas are filled with specified color (e.g., #5a85b9)
• Advanced Thumbnail Controls: Full control over thumbnail generation
  • keepAspectRatio parameter: Control whether thumbnails maintain aspect ratio or use exact dimensions
  • fromOriginal parameter: Choose to generate thumbnails from original uploaded image or processed image
  • fillColor parameter: Fill empty areas with background color when aspect ratio is maintained
• Thumbnail Configuration: New environment variables for thumbnail defaults
  • VORMIA_MEDIAFORGE_THUMBNAIL_KEEP_ASPECT_RATIO (default: true)
  • VORMIA_MEDIAFORGE_THUMBNAIL_FROM_ORIGINAL (default: false)
• Consistent File Naming: Predictable file naming patterns for all processed images
  • Resize: {baseName}-{width}-{height}.{extension}
  • Resize + Convert: {baseName}-{width}-{height}-{format}.{format}
  • Thumbnails: {baseName}_{suffix}.{extension}

Changed

• Resize Operation: Always saves with width-height format for consistent naming
• File Path Handling: Improved path resolution to ensure files are saved in correct directories
• Thumbnail Generation: Enhanced to support multiple control options with config defaults

Fixed

• Resize Directory Issue: Fixed resize operations saving to wrong directory when override=false
• Background Fill Bug: Fixed background fill color hiding the image - now properly creates canvas with fill color
• Thumbnail Source Selection: Fixed fromOriginal parameter to correctly use original uploaded file instead of processed image
• File Naming: Fixed return values to reflect correct file names after resize and convert operations
• Path Consistency: Ensured all processed files (resized, converted, thumbnails) are saved in the same directory

Documentation

• Updated AI/MCP Guide: Added comprehensive MediaForge usage examples and configuration
• Updated AI/MCP Rules: Added MediaForge code patterns and best practices
• Updated README.md: Added MediaForge usage section with examples and configuration
• Updated AI Docs: Enhanced documentation with all new features

Added

• Version Management: Proper version field in composer.json and consistent versioning
• Tag Cleanup: Resolved git tag organization issues and standardized versioning
• Release Process: Streamlined release process with proper version management

Changed

• Version Bump: Major version bump from 4.2.x to 4.3.0 for better semantic versioning
• Documentation: Updated all version references across the package

Added

• New API Authentication Middleware: Added ApiAuthenticate middleware with 'api-auth' alias for protected API routes
• Comprehensive AI Documentation: Added dedicated AI guidance for assistants and developers
• Database Dependency Protection: Added error handling in service providers to prevent crashes before migrations run
• Enhanced Troubleshooting: Added comprehensive troubleshooting section in README with cache management instructions
• Cache Management Methods: Added clearCache(), fresh() methods to UtilityService for better performance

Changed

• Meta Methods Standardization: Unified setMeta/getMeta methods across User and Taxonomy models for consistency
• Service Provider Robustness: Enhanced UtilitiesServiceProvider, GlobalDataServiceProvider, and TokenServiceProvider with database connection checks
• Documentation Structure: Reorganized and enhanced README with better examples and usage patterns
• Installation Process: Updated InstallCommand to include new middleware aliases automatically

Fixed

• Type System Confusion: Clarified utilities table structure and corrected usage patterns
• Service Provider Errors: Fixed database connection errors that occurred before migrations
• Meta Method Inconsistency: Resolved confusion between setMeta/setMetaValue methods
• Test Failures: Fixed PHPUnit tests in MediaForgeDependencyTest and InstallationTest

Documentation

• New AI Guides: Created comprehensive guides for LLM models and IDE AI assistants
• Usage Examples: Added practical code examples for all major features
• Troubleshooting: Added common issues and solutions section
• API Documentation: Enhanced API usage examples and middleware documentation

Breaking Changes

• Any changes that break existing functionality
• Migration steps required

New Features

• What's new in this version
• How to use new features

Improvements

• Performance improvements
• Code quality enhancements
• Better error handling

Bug Fixes

• Issues resolved in this version
• Workarounds no longer needed

Installation & Migration

• How to upgrade from previous versions
• Any new configuration requirements
• Database changes if applicable

When adding new entries to this changelog, please follow the established format and include:

• Clear description of changes
• Impact on existing functionality
• Migration steps if breaking changes
• Examples of new features

Added

• Initial package structure and basic functionality

Changed

• Core package implementation

Fixed

• Basic package setup and configuration

Added

• Basic user management features

Changed

• Package structure improvements

Fixed

• Initial package bugs

Added

• Role and permission system

Changed

• Enhanced user management

Fixed

• Permission-related issues

Added

• Taxonomy system

Changed

• Improved role management

Fixed

• Taxonomy-related bugs

Added

• Utility service

Changed

• Enhanced taxonomy system

Fixed

• Utility service issues

Added

• Media forge service

Changed

• Improved utility service

Fixed

• Media processing bugs

Added

• API authentication

Changed

• Enhanced media forge

Fixed

• API-related issues

Added

• Major version features

Changed

• Significant improvements

Fixed

• Major bug fixes

Added

• Minor features

Changed

• Small improvements

Fixed

• Minor bugs

Added

• Initial features

Changed

• Basic improvements

Fixed

• Basic bugs